home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / pc / dos / editors / read28 / cfdir.doc next >
Text File  |  1992-09-29  |  11KB  |  251 lines
  1.  
  2.                   CFDIR 1.2, copyright (c) 1992 DLJ Software
  3.  
  4.  
  5.                             DLJ Software
  6.                             182 Maplewood Circle
  7.                             Urbana, Ohio  43078-9255
  8.  
  9.  
  10.                       Compressed File DIRectory utility
  11.  
  12.  
  13.  
  14.  
  15.     CFDir is NOT a full featured front end for your compression/decompression
  16.     utilities.  It is a utility that was created to work in conjunction with
  17.     the ReadIt text file viewer (version 2.7 and later) to enable the user
  18.     to read files within a compressed file without first extracting them.
  19.     CFDIR.EXE and CFDIR.DOC are a part of the ReadIt package.
  20.  
  21.     Although CFDIR was written to be used with ReadIt, it can also be used as
  22.     a "stand-alone" utility for viewing the directory of a compressed file.
  23.     You can also have CFDIR call up the appropriate de-compression utility to
  24.     extract one or more files from the compressed file.
  25.  
  26.     NOTE:  While CFDir does not need the help of a decompression utility to
  27.     display a list of files within a compressed file, it does call a
  28.     decompression utility to actually extract them.  Those utilities which
  29.     CFDir will use are listed later in this documentation.  DLJ Software does
  30.     not sell or distribute compression/decompression utilities.
  31.  
  32.     We will first discuss how to use CFDir as a "stand-alone" utility.  After
  33.     which, we will talk about using CFDir with ReadIt.
  34.  
  35.  
  36.  
  37.     Running CFDir:
  38.  
  39.  
  40.     As with READIT.EXE and RIC.EXE, you should place CFDIR.EXE in a directory
  41.     which is in your DOS path so that it can be run from anywhere on your
  42.     system.  This is also important because ReadIt must be able to find CFDir
  43.     in order to use it.
  44.  
  45.     You will need to have approximately 150kB of RAM available when you run
  46.     CFDir as a "stand-alone" utility if you intend to use it to extract
  47.     selected files.  NOTE:  Some decompression utilities need a large amount
  48.     of RAM available in order to run.  The amount of RAM mentioned above might
  49.     not be enough for some of these utilities.
  50.  
  51.     The format for using CFDir from the DOS command line is:
  52.  
  53.             CFDIR [drive][path][filespec] [/W-]
  54.  
  55.     The square brackets ([]) simply mean that the parameter which they
  56.     enclose is optional.  [drive] refers to a legal DOS drive specification
  57.     such as "A:", "B:", "C:", etc.  [path] refers to a legal DOS path such as
  58.     "\" (the root directory), "\DOS" (a sub-directory of the root directory),
  59.     or "DOCUMENTS" (a sub-directory of the current directory).  [filespec]
  60.     refers to a legal DOS filename and extension such as "FILES.ARC", or a
  61.     group of files specified by using the DOS wildcards "*" and/or "?" such as
  62.     "FILES.*" or "*.ARC".
  63.  
  64.     [/w-]  switches the picklist display from full file information ("wide"
  65.     display) to filenames and extensions only.  The /W switch must either be
  66.     the last parameter or the only parameter.  Anything that follows it on the
  67.     DOS command line will be ignored.
  68.  
  69.     If any of the parameters above are not specified, CFDir assumes default
  70.     values.  The defaults are as follows:
  71.  
  72.             drive           --  Current drive.
  73.             path            --  Current path (directory).
  74.             filespec        --  "*.*" (without the quotation marks).
  75.             /w+             --  full file info on picklist (wide display).
  76.  
  77.     It should be noted that, although you can use wildcards to specify the
  78.     file extension, only files with the extensions listed below will be
  79.     considered since CFDir only works with compressed files.  Valid file
  80.     extensions are:
  81.  
  82.             .ARC        .LZH        .ZIP        .ZOO        .ARJ        .PAK
  83.  
  84.     If you run CFDir and specify a single filename, CFDir will attempt to show
  85.     you a listing of the contents of that file.  If you use wildcards, or
  86.     do not specify any filespec, CFDir will attempt to show you a list of
  87.     compressed files residing on the current, or specified, drive and path.
  88.  
  89.  
  90.  
  91.  
  92.  
  93.     What CFDir looks like:
  94.  
  95.  
  96.     CFDir appears the same as the default ReadIt with the picklist up.  The
  97.     status line is displayed on the top line of the screen, and the help/error
  98.     message panel is displayed on the bottom two lines of the screen.  A
  99.     picklist containing filenames, file sizes, dates and time is displayed
  100.     between these two panels.
  101.  
  102.     The status panel will display either "Directory of..." or "Contents of..."
  103.     depending on what is being displayed in the picklist--either a list of
  104.     compressed files within the directory, or a listing of files within a
  105.     particular compressed file.
  106.  
  107.  
  108.  
  109.     CFDir commands:
  110.  
  111.     When CFDir is up and displaying a picklist, the following commands are
  112.     available.
  113.  
  114.             ESCAPE      --  Exit picklist or program.
  115.             ALT-X       --  Exit directly to DOS (eXpress eXit).
  116.             F1          --  Display help screen.
  117.  
  118.             UP ARROW    --  Move picklist highlight bar up one entry.
  119.             DOWN ARROW  --  Move picklist highlight bar down one entry.
  120.             PAGE UP or
  121.             PAGE DOWN   --  Scroll picklist up or down one screen full.
  122.             HOME or
  123.             END         --  Move highlight bar to beginning or end of
  124.                             picklist.
  125.             ENTER       --  Select highlighted entry.
  126.  
  127.  
  128.     As with ReadIt's picklist, you can sort the entries in CFDir's picklist.
  129.  
  130.             ALT-F1      --  Sort by filename.
  131.             ALT-F2      --  Sort by file extension.
  132.             ALT-F3      --  Sort by file size.
  133.             ALT-F4      --  Sort by file date and time.
  134.             ALT-F5      --  Sort by filenames, and within filename groups,
  135.                             sort by extensions.
  136.             ALT-F6      --  Sort by file extensions, and within extension
  137.                             groups, sort by filenames.
  138.             ALT-F9      --  Switch between ascending and descending order.
  139.  
  140.     When you first run CFDir from the DOS prompt, the picklist is displayed in
  141.     the order the files occur either in the directory or within the compressed
  142.     file.  Also, the picklist will be in "wide display" mode.  That means that
  143.     it will display full information about the files.  You can switch between
  144.     "files and extensions only" display and "full information" display, as you
  145.     can with ReadIt's picklist, by pressing the ALT-F10 combination.
  146.  
  147.  
  148.     The action performed when you press the ENTER (select entry) key depends
  149.     on what is being displayed in the picklist.
  150.  
  151.     If the picklist is displaying a list of files contained in a directory,
  152.     pressing the ENTER key will cause CFDir to attempt to display a list of
  153.     files within the highlighted compressed file in another picklist.
  154.     However, if a list of files within a compressed file is being displayed,
  155.     CFDir will attempt to find a decompression utility on your hard drive and
  156.     have it extract the highlighted file.
  157.  
  158.     NOTE:  CFDir first searches the current directory, and then searches all
  159.     directories included in the DOS path for a decompression (de-arching)
  160.     utility.  If you are not familiar with DOS environment variables or the
  161.     DOS path, refer to your DOS user's manual.  Below is a list of the
  162.     compression/decompression utilities that CFDir will search for:
  163.  
  164.         FOR .ARC:
  165.                 ARC-E.COM and
  166.                 ARCE.COM        --  Wayne Chin and Vernon D. Buerg
  167.                                     System Enhancement Associates
  168.                 PKUNPAK.EXE     --  PKWARE
  169.                 PKXARC.COM      --  PKWARE
  170.  
  171.         FOR .LZH:
  172.                 LHARC.EXE       --  Haruyasu Yoshizaki (Yoshi)
  173.                 LHA.EXE         --  Haruyasu Yoshizaki (Yoshi)
  174.  
  175.         FOR .ZIP:
  176.                 PKUNZIP.EXE     --      PKWARE
  177.                 UNZIP.EXE       --  BORLAND INTERNATIONAL
  178.  
  179.         FOR .ZOO:
  180.                 ZOO.EXE and
  181.                 ZOOX.EXE        --  Rahul Dhesi
  182.  
  183.         FOR .ARJ:
  184.             ARJ.EXE,
  185.             ARJR.EXE and
  186.             DEARJ.EXE           --  Robert K Jung.
  187.  
  188.         FOR .PAK:
  189.             PAK.EXE             --  NoGate Consulting
  190.  
  191.  
  192.      Over time, the authors of some of these utilities may have changed their
  193.      compressed file formats (".LZH" files for example).  If CFDir does not
  194.      work with your compressed files please inform us at DLJ Software.
  195.      Include the utilities name and version number.
  196.  
  197.     Note:  DLJ Software has no vested interest in any of the above mentioned
  198.     utilities, and makes no judgements or recommendations  as to their
  199.     usefulness, reliability, availability, etc..  We have simply made an
  200.     attempt to make CFDir compatible with as many decompression utilities as
  201.     is practical.
  202.  
  203.  
  204.  
  205.  
  206.  
  207.     Using CFDir with ReadIt:
  208.  
  209.     You will need to have approximately 250kB of RAM available before running
  210.     ReadIt in order to use ReadIt and CFDir to view text files within
  211.     compressed files.  Also, as mentioned above, CFDir should be placed in a
  212.     directory where ReadIt will be able to find it.  NOTE:  Because some of
  213.     the supported decompression utilities require a large amount of RAM, the
  214.     250k above may not be adequate for some users.
  215.  
  216.     Other than what is mentioned in the paragraph above, you need not do
  217.     anything special to use CFDir with ReadIt.  It's all pretty much
  218.     automatic.
  219.  
  220.     Think of a compressed file as being similar to a sub-directory, as far as
  221.     ReadIt is concerned.  There are only a few differences in the picklist
  222.     when in this "sub-directory".
  223.  
  224.         (1)     You can not perform DOS commands using the F10 key.
  225.         (2)     You can not rename or delete files in this directory.
  226.         (3)     You can not use ALT-f8 to have ReadIt turn off sorting and
  227.         "       reread" this directory.  And,
  228.         (4)     You need to press the ESCAPE key to return to the previous
  229.                 directory.
  230.  
  231.     That's about it!  Also, although you can not change the appearance of
  232.     CFDir as a stand-alone utility, It is a bit of a chameleon when used with
  233.     ReadIt.  What that means is, When used with ReadIt, CFDir will take on the
  234.     same "look".
  235.  
  236.  
  237.  
  238.  
  239.  
  240.     Sharing CFDir with others:
  241.  
  242.     CFDIR.EXE and CFDIR.DOC are not free.  They are copyrighted and are part
  243.     of the ReadIt shareware package.  Refer to the ReadIt documentation for
  244.     information on how the ReadIt package may be shared with others for
  245.     evaluation purposes.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.